home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / inn-1.4 / faq-inn-1 next >
Encoding:
Internet Message Format  |  1993-12-02  |  28.9 KB

  1. Path: uunet!news.mentorg.com!sdl!not-for-mail
  2. From: tal@Warren.MENTORG.COM (Tom Limoncelli)
  3. Newsgroups: news.software.nntp,news.software.b,news.answers
  4. Subject: INN FAQ Part 1/3: General Information, how to compile, how to operate
  5. Supersedes: <inn-faq-1-752475605@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 20 Nov 1993 05:00:10 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 766
  10. Sender: tal@Warren.MENTORG.COM
  11. Approved: news-answers-request@MIT.Edu
  12. Distribution: world
  13. Expires: 12/05/93
  14. Message-ID: <inn-faq-1-753771605@Warren.MENTORG.COM>
  15. Reply-To: Tom_Limoncelli@Warren.MENTORG.COM (Tom Limoncelli)
  16. NNTP-Posting-Host: sdl.warren.mentorg.com
  17. X-Summary-1: Part 1: Common questions about INN itself, and some advice when compiling it and installing it.
  18. X-Summary-2: Part 2: This assumes that you've successfully compiled the software.  This is a tutorial that takes you through configuration and setting up feeds.  It ends with common questions about INN configuration.
  19. X-Summary-3: Part 3: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.)
  20. Xref: uunet news.software.nntp:6504 news.software.b:15172 news.answers:14977
  21.  
  22. Posted-By: auto-faq 2.4
  23. Archive-name: inn-faq/part1
  24.  
  25. Last Changed: $Id: FAQ-inn.1,v 1.47 1993/10/14 16:20:24 tal Exp tal $
  26.  
  27.                           Table Of Contents:
  28.                           ------------------
  29.  
  30. QUESTIONS FROM PEOPLE THAT DON'T (YET) RUN INN:
  31.     Where can I get it?
  32.     What is INN?
  33.     What machines does it run on?
  34.     Can I run C News with INN?
  35.     Can I run NNTP with INN?
  36.     Can I run the reference implementation (NNTP1.5) with INN?
  37.     Can I run INN on my UUCP-only machine?
  38.     Suppose I have a 286 machine?
  39.     Does INN implement trn's XTHREADS, etc?
  40.     Does INN do UUCP batching like C News?
  41. COMMON DEBUGGING/SETUP QUESTIONS:
  42.     Help!?  How do I configure this beast
  43.     Why does innd just exit right away with no message?
  44.     I'm getting news but postings aren't going out.
  45.     How come my host name comes out twice in the Path line?
  46.     Why does my innd often die with the message "Can't sync history,
  47.     7-bit encoded batches are not correctly processed. Why is this?
  48. SPECIFIC OPERATING SYSTEM BUILD ADVICE:
  49.     SunOS 4.1.2
  50.     Ultrix tip 1 (mmap)
  51.     Ultrix tip 2 (syslog)
  52.     HP-UX
  53.     Pyramid and system's where only root can have "cron" jobs.
  54.     SVR4, Solaris 2.x, and SCO ODT 3.0
  55. OPERATIONAL QUESTIONS:
  56.     Safe way to edit the "active" file?
  57.     Expire had problems last night, and while I fixed the problem
  58.         it still won't run.
  59.     Why am I getting alt.sex.pictures even though I
  60.         have "ME:!alt.sex.pictures" in my newsfeeds file?
  61.     Why doesn't this newsfeeds entry do what I want?
  62.     Why am I forwarded cancel messages for articles in comp.foo
  63.         when I explicitly have !comp.foo in the newsfeeds entry?
  64.     What's the best way to upgrade to a new version of INN?
  65. ADVANCED QUESTIONS:
  66.     What do I do if /var/spool/news is set up over many partitions?
  67.     How do I talk to innd from C or Perl?
  68.     How do I set up a delayed IHAVE/SENDME over NNTP?
  69.  
  70.  
  71. (The FAQ was written by Rich $alz <rsalz@rodan.uu.net> and is now
  72. maintained by Tom Limoncelli <tal@warren.mentorg.com>.)
  73.  
  74.  
  75. ======================================================================
  76.  
  77. ADVANCED QUESTIONS:
  78.             QUESTIONS FROM PEOPLE THAT DON'T (YET) RUN INN
  79.  
  80. ======================================================================
  81.  
  82.  
  83. ------------------------------
  84.  
  85. Subject:  Where can I get it?
  86.  
  87. The official archive site is ftp.uu.net in the directory
  88. networking/news/nntp/inn.  Archie current lists over 30 archive sites;
  89. three other international sites are grasp.insa-lyon.fr in
  90. pub/unix/news/inn, munnari.oz.au in pub/news/inn, and src.doc.ic.ac.uk
  91. in computing/usenet/software/transport
  92.  
  93. This three-part FAQ is available via FTP whereever INN can be found.
  94.  
  95. You can also get this FAQ by sending email to
  96. majordomo@warren.mentorg.com with "sendme faq-inn-1" in the body of the
  97. message.  (the Subject: of the message will be ignored.) (Substitute
  98. faq-inn-2 or faq-inn-3 to get those parts).
  99.  
  100. For example:
  101.  
  102. % echo sendme faq-inn-1 | mail majordomo@warren.mentorg.com
  103. % echo sendme faq-inn-2 | mail majordomo@warren.mentorg.com
  104. % echo sendme faq-inn-3 | mail majordomo@warren.mentorg.com
  105.  
  106. or
  107.  
  108. % mail majordomo@warren.mentorg.com
  109. Subject: ignored
  110. sendme faq-inn-1
  111. sendme faq-inn-2
  112. sendme faq-inn-3
  113. ^D
  114.  
  115.  
  116. ------------------------------
  117.  
  118. Subject:  What is INN?
  119.  
  120. InterNetNews is a complete Usenet system.  The cornerstone of the package
  121. is innd, an NNTP server that multiplexes all I/O.  Think of it as an nntpd
  122. merged with the B News inews, or as a C News relaynews that reads multiple
  123. NNTP streams.  Newsreading is handled by a separate server, nnrpd, that is
  124. spawned for each client.  Both innd and nnrpd have some slight variances
  125. from the NNTP protocol (although in normal use you will never notice); see
  126. the manpages.  INN separates hosts that feed you news from those that have
  127. users reading news.  If you need to support a mixed environment you will have
  128. to do some extra work; the installation manual gives some hints.
  129.  
  130.  
  131. ------------------------------
  132.  
  133. Subject:  What machines does it run on?
  134.  
  135. If you have socket() and select() then INN will probably run on your
  136. machine.  In addition to the common platforms found around the Internet
  137. (Sun and Ultrix, for example), INN runs on AIX, A/UX, NeXT, and a host of
  138. others.
  139.  
  140.  
  141. ------------------------------
  142.  
  143. Subject:  Can I run C News with INN?
  144.  
  145. No.  INN handles all article reception, filing, forwarding, and
  146. expiration.  You will most likely get a corrupted database if you try to
  147. run INN with any other news system.  For testing, you can probably shut
  148. down your old system, bring up INN, and then reverse the process.  (INN
  149. uses the C News history file and DBZ database, so if you don't run C News
  150. you will have to do some fiddling around with those files.)
  151.  
  152.  
  153. ------------------------------
  154.  
  155. Subject:  Can I run NNTP with INN?
  156.  
  157. There's a confusion here.  NNTP is a protocol, defined in RFC 977.  There
  158. is also an implementation of the protocol, NNTP1.5, that many people call
  159. NNTP.  When there was only one implementation of the protocol, that was
  160. okay, but now that there are other implementations (for example, INN) it
  161. is getting confusing.  It would be as if "sendmail" were named "smtp."
  162. Please try to be clear -- do you mean the NNTP protocol, or the NNTP
  163. reference implementation currently maintained by Stan Barber?
  164.  
  165.  
  166. ------------------------------
  167.  
  168. Subject:  Can I run the reference implementation (NNTP1.5) with INN?
  169.  
  170. The quick answer is no.  INN listens on the NNTP port and handles all
  171. incoming traffic.  It receives articles, files them, and arranges for them
  172. to be forwarded to your peers.  If a site connects that is not listed as a
  173. peer (e.g., a local workstation that does newsreading) then the INN server
  174. hands the connection off to another program.  By default, this is nnrpd,
  175. which implements the NNTP protocol for newsreaders (for example, it
  176. includes the POST command but not the IHAVE command).  You can run the
  177. reference implementation server instead of nnrpd if you want.  Doing this
  178. can be useful if you have clients that want to do both reading and article
  179. transfer.
  180.  
  181.  
  182. ------------------------------
  183.  
  184. Subject:  Can I run INN on my UUCP-only machine?
  185.  
  186. Sure.  While not designed for this, several people are running INN on
  187. machines that do not have IP-connectivity (such as UUCP-only hosts) and
  188. are quite happy with it.  You might want to give it a try, especially if
  189. you think you will be joining the Internet some day.
  190.  
  191.  
  192. ------------------------------
  193.  
  194. Subject:  Suppose I have a 286 machine?
  195.  
  196. Won't work.  INN is designed to be a memory hog; a server that has been up
  197. for a few days while will have a working set size of a few to several
  198. megabytes, although not all of it will be resident.  For example, the
  199. server keeps the active file and list of who gets what in memory, as well
  200. as all articles that it is receiving.  Unless you can do things like
  201. "malloc(64 * 1024)" without pain, INN won't work on your machine.
  202.  
  203.  
  204. ------------------------------
  205.  
  206. Subject:  Does INN implement trn's XTHREADS, tin's commands, etc?
  207.  
  208. The XTHREAD command has code but it is not supported; look at
  209. $inn/nnrpd/nnrpd.h.  This code will probably vanish after 1.4.  Tin
  210. commands are not supported.  Instead, INN supports Geoff Collyer's news
  211. overview database, nov (world.std.com, src/news/nov.dist.tar.Z).  It
  212. does not include the client package; it just updates and maintains the
  213. overview databases.  For info on how to configure INN to use NOV, read
  214. Part 3/3 of this FAQ.  (Subject: Cookbook example setting up NOV
  215. ("overchan").)
  216.  
  217.  
  218. ------------------------------
  219.  
  220. Subject:  Does INN do UUCP batching like C News?
  221.  
  222. Not as part of the standard distribution.  The batching system right
  223. now is better than B News, but Rich has said he will be working on
  224. improving that part of INN in a future release.  Christophe Wolfhugel
  225. <Christophe.Wolfhugel@grasp.insa-lyon.fr> has written a package that is
  226. very much like the C News batching system, however.  You can find it on
  227. grasp.insa-lyon.fr in the pub/unix/news/inn/contrib directory.
  228.  
  229. Version 3 of Christophe's package includes a shell version and a Perl
  230. version.  Version 4, not yet planned will only be in Perl. The
  231. configuration file has evolved from older releases in order to support
  232. new features like minimum batching".
  233.  
  234.  
  235. ======================================================================
  236.  
  237.                    COMMON DEBUGGING/SETUP QUESTIONS
  238.  
  239. ======================================================================
  240.  
  241.  
  242. ------------------------------
  243.  
  244. Subject:  Help!?  How do I configure this beast
  245.  
  246. Two people have written tutorials on installing INN.  The first one has
  247. become Part 2 of this FAQ and concentrates on building INN (compiling
  248. and gathering the needed external software).  The other tutorial has
  249. become Part 3 of this FAQ and concentrates on configuration and
  250. debugging said configuration (it used to be called inn-tutorial before
  251. it became part of the FAQ).
  252.  
  253.  
  254. ------------------------------
  255.  
  256. Subject:  Why does innd just exit right away with no message?
  257.  
  258. First, fix your syslog: innd always logs a message before it exits.  (The
  259. INN distribution includes a version of the current UCB syslog, along with
  260. instructions on how to install it.  Ultrix systems might want to look at
  261. the syslog that is available on gatekeeper.dec.com) Second, the most
  262. common cause of this is that you do not have a history file (or no history
  263. database).  You will see a message like this:
  264.     ME cant dbminit /usr/local/news/history No such file or directory
  265. This means that you do not have a history database.  You might want to run
  266. the BUILD script in your INN source tree or read about makehistory in
  267. doc/news-recovery.8; if you do the latter, make sure to rename the
  268. database files.  This FAQ covers general questions about INN and questions
  269. about how to compile it.  For information on configuration and debugging
  270. one's configuration, see the "INN Configuration FAQ".
  271.  
  272.  
  273. ------------------------------
  274.  
  275. Subject:  I'm getting news but postings aren't going out.
  276.  
  277. You might find it helpful to read "Appendix IV:  First-time Usenet or NNTP
  278. Installation" in the Install manual.  In order for postings to go out, you
  279. must have a newsfeeds entry that names a site to receive them.  In the
  280. standard case you want to record the article filename and Message-ID in a
  281. batchfile for the site:
  282.     myfeed/myfeed.dom.main:*,!foo.*\
  283.     Tf,Wnm:
  284. You now want to run send-nntp or nntpsend from cron so that the file is
  285. flushed and that innxmit is called to read the file and send the articles
  286. out.  See the manual pages.
  287.  
  288.  
  289. ------------------------------
  290.  
  291. Subject:  How come my host name comes out twice in the Path line?
  292.  
  293. The INN server puts its name in the Path line of every article that it
  294. receives.  Obviously, it has to do this.  The default configuration has
  295. inews put the local host in the Path header.  If nobody posts on the
  296. server and you use fully-qualified domain names on your workstations,
  297. then everything works the right way.  (If `hostname` doesn't give an
  298. FQDN on your machine, you can work-around this by setting the "domain"
  299. value in inn.conf; remember that innd never re-reads inn.conf.  You
  300. must "ctlinnd shutdown x" and then re-start the server).  Many people
  301. don't want the client machines to put their name in the Path header.
  302. To do this, set INEWS_PATH to DONT.  Finally, let me say that it is
  303. probably a mistake to have a "pathhost" line on any machine other than
  304. your server if you set INEWS_PATH to DO.  If you doubt this, please
  305. trace the article flow for yourself.  If you are curious about the
  306. effect of INEWS_PATH, read the nroff source -- not the formatted
  307. output -- of doc/inews.1
  308.  
  309.  
  310. ------------------------------
  311.  
  312. Subject:  Why does my innd often die with the message "Can't sync history,
  313.       interrupted system call"
  314.  
  315. Are you running SunOS?  If so, the answer is that Sun broke the write
  316. system call but a patch is available.  Any write could fail in this way,
  317. it is just more likely to happen when writing large files and in-core DBZ
  318. writes the history file out in one chunk.  See the "Known Problems"
  319. section of the installation manual.  To the best of my knowledge, nobody
  320. has seen this problem on any other system.
  321.  
  322.  
  323. ------------------------------
  324.  
  325. Subject: How do I create all those directories in the newsspool?
  326.  
  327. Q:  For example, if you receive comp.sys.amiga.applications, do you
  328. have to mkdir /var/spool/news/comp/sys/amiga/applications?
  329.  
  330. A:  Nope.  innd creates the directory for you the first time you
  331. receive an article for that newsgroup.
  332.  
  333.  
  334. ------------------------------
  335.  
  336. Subject: 7-bit encoded batches are not correctly processed. Why is this?
  337.  
  338. Chris Schmidt <cs@germany.eu.net> replies:
  339.  
  340. The decode program that comes with INN up to version 1.3 is broken.
  341. Because of that the last article in a 7bit encoded batch will not
  342. correctly be decoded (the last characters are screwed up).  This is
  343. fixed in INN 1.4.
  344.  
  345.  
  346. ======================================================================
  347.  
  348.                 SPECIFIC OPERATING SYSTEM BUILD ADVICE
  349.  
  350. ======================================================================
  351.  
  352.  
  353. ------------------------------
  354.  
  355. Subject: SunOS 4.1.2
  356.  
  357. SunOS 4.1.2 (but not 4.1.1 or 4.1.3) broke the write system call but a
  358. patch is available.  Any write could fail "half way", it is just more
  359. likely to happen when writing large files and in-core DBZ writes the
  360. history file out in one chunk.  See the "Known Problems" section of the
  361. installation manual.
  362.  
  363.  
  364. ------------------------------
  365.  
  366. Subject: Ultrix tip 1 (mmap)
  367.  
  368. Ultrix has a "mmap()" function, but it doesn't do the same thing as the
  369. SunOS/BSD mmap() function.  Therefore, do not configure INN to use
  370. mmap() on a Ultrix system.  INN wants to find a mmap() function
  371. that is like the one on SunOS/BSD systems.
  372.  
  373.  
  374. ------------------------------
  375.  
  376. Subject: Ultrix tip 2 (syslog)
  377.  
  378. The syslog on Ultrix sucks rotten eggs and Digital refuses to fix it.
  379. (source: everyone that uses Ultrix and has ever used other systems)
  380.  
  381. Luckily, you can replace it with the routine that comes with INN.
  382. However, some people have had better luck installing the syslog that
  383. can be had on gatekeeper.dec.com:/pub/DEC/jtkohl-syslog-complete.tar.Z
  384. It still works with old clients but does new-style syslogging, too.
  385. Works great for me so far.  (this information from:  nelson@reed.edu
  386. (Nelson Minar)).  The syslog that is shipped with INN works pretty well
  387. but there have been some claims that some old clients don't like it.
  388.  
  389.  
  390. ------------------------------
  391.  
  392. Subject: HP-UX
  393.  
  394. Q. I am running inn on an HP machine. Inn won't start up automatically
  395. :-( I can start it manually. There is no problem with news or inn once
  396. it is started.
  397.  
  398. A.  Try adding a "sleep 10" to the bottom of /etc/rc.news, or in
  399. /etc/rc, right after /etc/rc.news is invoked.  On some machines,
  400. including HP, the shell started by "#!/bin/sh" when /etc/rc is executed
  401. will exit before innd has disassociated itself from that shell.  This
  402. causes innd to exit, sometimes without printing an error message.
  403. (source: pjoslin@mbvlab.wpafb.af.mil (Paul Joslin ))
  404.  
  405. This problem goes away if you set HAVE_SETSID to "DO".  Something to do
  406. with Posix Session Leader concepts. Ick. (source:
  407. scotty@piranha.cs.uoguelph.ca (Steve Howie))
  408.  
  409. HP-UX 8.07 users might find a problem with getting innwatch to
  410. start up.  People have found that having "at" start it seems
  411. to work more reliably than other methods:
  412.  
  413. ${DOINNWATCH} && {
  414.     echo "su ${NEWSUSER} -c ${INNWATCH}" | /usr/bin/at now +2 minutes
  415. #    echo "( ( sleep 60 ; ${INNWATCH} ) & )" | su ${NEWSUSER}
  416. }
  417.  
  418.  
  419. ------------------------------
  420.  
  421. Subject: Pyramid and system's where only root can have "cron" jobs.
  422.  
  423. Your cron jobs may not work if you use:
  424.  
  425.     su news -c /usr/lib/news/bin/news.daily delayrm expireover
  426.  
  427. Instead, you must put the entire command in quotes.  Like this:
  428.  
  429.     su news -c "/usr/lib/news/bin/news.daily delayrm expireover"
  430.  
  431. Look for "Pyramid" in part 3 of this FAQ for details.
  432.  
  433.  
  434. ------------------------------
  435.  
  436. Subject: System V based Unixes (SVR4, Solaris 2.x, SCO ODT 3.0, A/UX, ...)
  437.  
  438. If you are running any non-BSD (i.e. System V based) Unix you MUST have
  439. the following option set:
  440.  
  441. ##  How should close-on-exec be done?  Pick IOCTL or FCNTL.
  442. #### =()<CLX_STYLE              @<CLX_STYLE>@>()=
  443. CLX_STYLE               FCNTL
  444.  
  445. This includes SVR4, Solaris 2.x, A/UX and SCO ODT 3.0.  This is clearly
  446. stated in the Install.ms file and repeated here since so many people
  447. post to news.software.nntp after messing it up.
  448.  
  449. If it isn't FCNTL, you'll get tons of overchan processes hanging
  450. around.  (source: Philip Gladstone <philip@charon.cto.citicorp.com>)
  451.  
  452. In SCO ODT 3.0 and MOST systems, innd will link and run if you use
  453. IOCTL but eventually will stop answering incoming calls.
  454.  
  455. Don't be fooled.  Just because it compiles doesn't mean it's going to
  456. work.
  457.  
  458. Under Solaris 2.x (SunOS 5.x) you must add the following at the
  459. beginning of each file using gethostbyname():
  460.  
  461. #define gethostbyname __switch_gethostbyname
  462.  
  463.  
  464. ------------------------------
  465.  
  466. Subject: Mac running A/UX 3.0
  467.  
  468. Use the INN malloc.
  469.  
  470.  
  471. ======================================================================
  472.  
  473.                         OPERATIONAL QUESTIONS
  474.  
  475. ======================================================================
  476.  
  477.  
  478. ------------------------------
  479.  
  480. Subject:  Safe way to edit the "active" file?
  481.  
  482. The following sequence is the shortest:
  483.  
  484. ctlinnd pause "edit active"
  485. [do something to the active file]
  486. ctlinnd reload active "edit active"
  487. ctlinnd go "edit active"
  488.  
  489. Simple!  No need to "flush" after step one.
  490.  
  491.  
  492. ------------------------------
  493.  
  494. Subject:  Expire had problems last night, and while I fixed the problem,
  495.       it still won't run.
  496.  
  497. When expire starts up it "reserves" the server so that nobody else can
  498. pause or throttle it.  This prevents anyone else from coming in and
  499. modifying the history database.  If expire bails out because of a bad
  500. error (e.g., your expire.ctl has syntax errors) it leaves the server
  501. reserved so that no maintenance will be done until a good expire run has
  502. occurred.  To unblock the server, use the ctlinnd "reserve" command with
  503. an empty string argument.
  504.  
  505.  
  506. ------------------------------
  507.  
  508. Subject:  Why am I getting alt.sex.pictures even though I have
  509.       "ME:!alt.sex.pictures" in my newsfeeds file?
  510.  
  511. The active file is the definitive list of what newsgroups you receive.
  512. INN's ME entry is different from C News and B News; please see
  513. newsfeeds.5.  If you do not want to receive alt.sex.pictures, ask the
  514. system(s) that send you news not to send it to you.  (You would have to do
  515. that no matter what news system you are running.)
  516.  
  517.  
  518. ------------------------------
  519.  
  520. Subject:  Why doesn't this newsfeeds entry do what I want?
  521.       "foo.com:alt,!alt.sex"
  522.  
  523. A newsfeeds entry is not a sys file (C News) entry.  Please read
  524. newsfeeds.5.  You might also find the sys2nf program in the frontends
  525. directory useful, as well as the inncheck Perl script that is found in
  526. the samples directory.  The INN Configuration FAQ has cook-book
  527. examples of the steps required to install a NNTP feed, UUCP feed, and
  528. NNTP via nntplink feed.
  529.  
  530.  
  531. ------------------------------
  532.  
  533. Subject:  Why am I forwarding cancel messages for articles in comp.foo
  534.       when I explicitly have !comp.foo in the newsfeeds entry?
  535.  
  536. Control messages can be explicitly forwarded, so a control message to
  537. comp.foo is forwarded to sites that recieve either comp.foo or control.
  538. Please see the "Control Messages" section of innd.8.  As that
  539. documentation says, you probably want to put "!control" in the
  540. subscription list for most of your newsfeeds.
  541.  
  542.  
  543. ------------------------------
  544.  
  545. Subject:  What's the best way to upgrade to a new version of INN?
  546.  
  547. First, you should read the README and the Install.ms (yes, read
  548. them both... again).  The README includes a technique to update
  549. a new config.data file to be like your old one:
  550.  
  551.       % cd config
  552.       % make subst
  553.       % cp config.dist config.data
  554.       % ./subst -f {OLDFILE} config.data
  555. where "{OLDFILE}" names your old config.data file.
  556.  
  557. Now edit the config.data to see if you want to change any of
  558. the new settings that didn't exist in the old version's config.data
  559. file.
  560.  
  561. Compile everything:
  562.  
  563.     % cd $INN
  564.     % make world
  565.  
  566. When you feel you are ready to install the new files shut the old daemon:
  567.  
  568.     % ctlinnd shutdown 'upgrade in progress'
  569.     [ kill innwatch by hand if you need to ]
  570.  
  571. Install the new files:
  572.  
  573.     % cd $INN
  574.     % make update
  575.  
  576. Now update all your $INN/site files to be the same as they were for
  577. your old software.  "cd $INN/site ; make diff-installed" will tell
  578. you what's different between the files in /usr/lib/news and $INN/site.
  579. If you only make changes in the $INN/site directory and use "make install"
  580. to copy them into place you'll save your self a lot of trouble.
  581. Read $INN/site/Makefile for more interesting things that "make" can
  582. do.
  583.  
  584. When you feel you are ready to install the new $INN/site files:
  585.  
  586.     % cd $INN/site
  587.     % make install
  588.  
  589. Re-start the system:
  590.  
  591.     % sh /usr/lib/news/etc/rc.news
  592.  
  593. If everything was done right you should be up and running.  Part 2 of
  594. the FAQ gives tips on testing your configuration.
  595.  
  596.  
  597. ------------------------------
  598.  
  599. Subject:  Can I use gzip with INN?
  600.  
  601. (this was written with the help of Michael Brouwer <michael@tar.wft.stack.urc.tue.nl>)
  602.  
  603. There are three things that can be effected by using gzip:  Compression
  604. of old logs, compressing batches to send out, and decompressing batches
  605. that come in.
  606.  
  607. With INN 1.4 all you need to do is change two lines in config.data to
  608. something like this:
  609.  
  610. COMPRESS                /usr/local/bin/gzip
  611. DOTZ                    .gz
  612.  
  613. If you rebuild INN with these options set, all logs will be gzipped, and rnews
  614. will use gzip to decompress news.
  615.  
  616. gzip will automaticly and transparently decompress UNIX Compress, SCO
  617. UNIX Compress (I'm told it's 99% compatible with UNIX Compress), Pack,
  618. and gzip.  Therefore, you can now receive batches compressed with any
  619. of the above listed formats.  Let's refer to this as "your site is now
  620. a universal decompresser".
  621.  
  622. It has been reported that if you hardlink gzip to be zcat, and make
  623. sure that it is the zcat that INN uses, you can get the "universal
  624. decompresser" without having to use gzip for your logs.  (Though, gzip
  625. for your logs is a big win, so why make trouble for yourself?)
  626.  
  627. `send-uucp' will still use compress for outgoing batches, so the sites
  628. you feed won't suddenly start getting data they don't understand.
  629.  
  630. Before you can send gzipped batches, you should make sure that the
  631. sites that you feed have made the above changes so that they have the
  632. "universal decompresser" too.
  633.  
  634. Edit send-uucp to use gzip instead of compress for certain hosts (see
  635. example of using compress -b12 for the host esac in send-uucp),
  636. outgoing batches will be gzipped.
  637.  
  638. If you use sendbatch, you will have to edit the file so that COMPRESS
  639. is set to "gzip" and COMPFLAGS is set to "-9vc".
  640.  
  641.  
  642. ======================================================================
  643.  
  644.                           ADVANCED QUESTIONS
  645.  
  646. ======================================================================
  647.  
  648.  
  649. ------------------------------
  650.  
  651. Subject:  What do I do if /var/spool/news is set up over many partitions?
  652.  
  653. First of all, you can do this by either mounting a filesystem at
  654. /var/spool/news/comp (for example) or by mounting a filesystem anywhere
  655. and making /var/spool/news/comp a symbolic link to the new partition.
  656.  
  657. Articles will be written as normal, but cross-posts have to be handled
  658. specially now.  Usually INN handles crossposts by writing the article
  659. to the first newssgroup, and then creating hard links to all the other
  660. places where the article should appear.  Hard links do not take up
  661. additional disk space (except making your directories longer).  Hard
  662. links also have the advantage that the file data doesn't get deleted
  663. until the last hard link is gone (and they can be deleted in any
  664. order).  Therefore, you can expire each newsgroup at a different rate,
  665. but the file data won't delete until it is expired from the last
  666. newsgroup.
  667.  
  668. The problem is that two hard linked files must both be on the same
  669. filesystem (partition).
  670.  
  671. When INN sees that it can not make a hard link (because an article is
  672. cross-posted across two partitions) it will try to make a symbolic
  673. link.  If your system can not do symbolic links, set HAVE_SYMLINKS to
  674. DONT in your config.data file.  This will make INN write a second
  675. (or third, etc.) copy of the file instead.  (NOTE: INN 1.4 doesn't
  676. make the extra files.  This feature is planned for INN 1.5.)
  677.  
  678. Anyway, even though INN will automatically create symbolic links, you
  679. have to give expire the "-l" flag so that it will know to modify its
  680. behavior.  Suppose that a message is posted to rec.photo and
  681. alt.cameras and suppose that rec.photo expires more quickly then the
  682. alt group.  If this happens, then you will be left with a dangling
  683. symlink.  The -l flag prevents this from happening.
  684.  
  685. To inform expire that your spool is split across multiple partitions:
  686.  
  687. In news.daily, change:
  688.     EXPIREFLAGS="-v1"
  689. to read
  690.     EXPIREFLAGS="-v1 -l"
  691.  
  692. In expirerm, change:
  693.     RMPROC="fastrm -e -u -s ${SPOOL}"
  694. to read
  695.     RMPROC="fastrm -e -s ${SPOOL}"
  696.  
  697. You also have to edit innwatch and innstat.  After that, you're done!
  698.  
  699. If you ever need to run "makehistory" you should pay attention to this
  700. caveat in makehistory(8):
  701.  
  702.     Makehistory does not handle symbolic links.  If the news
  703.     spool area is split across multiple partitions, the follow-
  704.     ing commands should probably be run before the database is
  705.     regenerated:
  706.         cd /usr/spool/news
  707.         find . -type l -print | xargs -t rm
  708.  
  709. However, if /var/spool/news/comp was a symlink to the partition
  710. that comp is really on, you'll have to reinstall that link.  You
  711. have avoid this by changing the above commands to:
  712.         cd /usr/spool/news
  713.         find . -type l -print | grep '[0-9][0-9]*' | xargs -t rm
  714.  
  715. ------------------------------
  716.  
  717. Subject:  How do I talk to innd from C or Perl?
  718.  
  719. Rich Salz says:
  720.  
  721. If you are writing C, look at doc/inndcomm.3 and include/inndcomm.h;
  722. they include all you need to do any ctlinnd command (in fact, ctlinnd
  723. itself is little more than a call to the library).
  724.  
  725. Hacking up a Perl subroutine that spoke to innd's Unix-domain control
  726. socket should be fairly straightforward but hasn't yet been written.
  727.  
  728.  
  729. ------------------------------
  730.  
  731. Subject:  How do I set up a delayed IHAVE/SENDME over NNTP?
  732.  
  733. Christophe Wolfhugel <Christophe.Wolfhugel@grasp.insa-lyon.fr> writes:
  734.  
  735. INN now allows to generate a timestamp entry in the batchfiles or to
  736. the channels/exploders (Wt in newsfeeds) which can be used to allow (for
  737. example) delayed ihave/sendme processing.  INN's senders (like innxmit)
  738. do not use that data yet.
  739.  
  740. Christophe.Wolfhugel@grasp.insa-lyon.fr has written a small patch for
  741. nntplink 3.1.0 which supports this.  The patch is available via
  742. anonymous FTP at "grasp.insa-lyon.fr:pub/unix/news/nntp/nntplink/delayed-1.0.pch".
  743.  
  744. The patch has been incorporated into nntplink 3.2, available from the
  745. nntplink distribution site, shape.mps.ohio-state.edu:/pub/nntplink/3.2pl1.tar.gz.
  746.  
  747. HOW TO DO IT:
  748.  
  749. The syntax that you would use in your newsfeeds file would be:
  750.  
  751.     site:*:Tf,Wnmt:
  752.  
  753. and run this command now and then:
  754.  
  755.     nntplink -i batchfile -y 300 -b site news.site.fr
  756.  
  757. The delayed IHAVE/SENDME is expected to allow bandwidth savings in
  758. situations where all sites use nntplink in following topology:
  759.  
  760.      Your site -- 64k -----------+-----------  Site 1
  761.                                  |               |
  762.                                  |              2mb
  763.                                  |               |
  764.                                  +------------ Site 2
  765.  
  766.    Site 1 and 2 are in the same metropolitan area, you feed them both.
  767.    With the standard nntplink layout, you generally send all articles
  768.    twice, which is a waste even if you're at 2 Meg/s link and even if
  769.    Site 1 and 2 do nntplinks, you're faster.
  770.  
  771.    The delayed link would be used between your site and Site 2.  A 2 or
  772.    3 minute delay allows Site 1 to feed Site 2 before you, and in case
  773.    of a Site 1 outage the backup starts nearly immediately.
  774.  
  775.    Reasonnable delays are still kept as You -> 1 -> 2 should take less
  776.    than one minute (or just 300 ms disk to disk if using nntplink -i ? :)).
  777.  
  778. Experiences seem to show that a 2 to 3 minutes delay is
  779. a reasonable choice.
  780.  
  781. Chris
  782.  
  783. -- 
  784. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  785. "Psst!  Hey, Anthony!  Y'know what I        | Disclaimer:  I do not
  786. like about existing?"  "Uh... uh... what?"  | speak for Mentor Graphics.
  787. "Possessing a physical extension."  -TSA    |
  788.